SAM Terminal Server Extensions
==============================

This software will allow the speech and braille devices attached to a local computer to be used by applications running within a terminal server session, with either the RDP or Citrix terminal programs.

Installing
----------
(Note: x: = the hard disk drive designator e.g. C:)

1) Install Citrix ICA Client and/or Microsoft Remote Desktop software

2) Install SAM 2.01 beta 3 on both the terminal server and the terminal client

3) On the terminal client, copy SamRemote.dll to either:-

   a) Citrix and RDP : the Citrix Client install directory which will usually be:-
      x:\Program Files\Citrix\ICA Client

   b) RDP only       : x:\Program Files\Dolphin\Sam

4) For RDP use, on the terminal client add the following registry key:-
   HKEY_CURRENT_USER\Software\Microsoft\Terminal Server Client\Default\AddIns\SamRemote

   Create a string value called "name" containing the path used in step 3 above.
   e.g. x:\Program Files\Citrix\ICA Client\SamRemote.dll

5) For Citrix use, on the terminal client edit the file x:\Program Files\Citrix\ICA Client\module.ini

   a) In the [ICA 3.0] section add "SamRemote" to the end of the "VirtualDriver" line.
      Ensure it is comma seperated and remains a single line

   b) In the [VirtualDriver] section add a line at end containing:-

      SamRemote =

   c) At the end of the file add a new section containing:

      [SamRemote]
      DriverName = SamRemote.DLL
      DriverNameWin16 =
      DriverNameWin32 = SamRemote.DLL

6) Install any applications that use SAM onto the terminal server such as SuperNova and follow any Terminal Server specific installation instructions.



Using
-----

1) Create a session on the terminal server by running either the Citrix Program Neighbourhood or Microsoft Remote Desktop Connection software. Sam will automatically start on the local machine.

2) Once logged in, start any SAM using application such as SuperNova. "Sam installed" will be spoken by any local synthesisers.

3) The application will probably default to using the first synth available which will usually be the version of Orpheus installed on the terminal server. This will be sluggish as audio is being sent across the network.

4) From the applications configuration panel select an alternative voice post-fixed with "(terminal)". This will use the device installed locally, which will be more responsive.

